home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr10 / vde165b.zip / VINST.REF < prev    next >
Text File  |  1993-06-08  |  48KB  |  807 lines
  1.  
  2.  
  3.                                   VINST.REF
  4.                                   ---------
  5.                   Instructions for VDE Installation Utility:
  6.                           version 1.65B (27 Apr 1993)
  7.  
  8.                              (c)1987-93, E. Meyer
  9.  
  10.  
  11.  
  12. ================================  CONTENTS  ==================================
  13.  
  14.  
  15.  1. RUNNING VINST.  What VINST is, and how to use it.
  16.  
  17.  2. INSTALLATION.  Installing for different computer hardware, colors, etc.
  18.  
  19.  3. MENUBAR MODE.  Choice of operating mode; customization of User menu bar.
  20.  
  21.  4. USER OPTIONS.  Customization of many initial VDE settings.
  22.  
  23.  5. PRINTER INSTALLATION.  Using printer features: print modes, graphics, etc.
  24.  
  25.  6. DEFAULT MACRO KEYS.  Installing a default set of macro keys.
  26.  
  27.  7. DEFAULT FUNCTION KEYS.  Installing the function keys.
  28.  
  29.  8. GRAPHICS.  Modifying the default set of graphics characters.
  30.  
  31.  9. CHARACTER WIDTHS.  Modifying the default set of character widths.
  32.  
  33. 10. RESTORE DEFAULTS.  Undoing previous modifications.
  34.  
  35.  
  36. ===========================  1. RUNNING VINST  ===============================
  37.  
  38.  
  39.      VINST is a utility that lets you modify your copy of the VDE editor:
  40.               * Installing for use on non-standard computers
  41.               * Selecting or customizing a driver for your printer
  42.               * Configuring settings and options to suit your tastes
  43.  
  44.      VDE comes configured for a standard IBM PC; you will need to make some 
  45. changes before using it on a non-IBM compatible computer, or a graphics card 
  46. (like old IBM CGAs) that experiences snow (see INSTALLATION).  You will want 
  47. to choose the correct driver for your printer, and may eventually want to make 
  48. some small modifications to it.  And, once you start editing with VDE, you 
  49. will probably discover some of its many settings and options that you would 
  50. like to change.  For example, if you dislike MenuBar mode, you can make 
  51. Command mode the default instead.
  52.  
  53.               NOTE: VINST allows VDE to be customized for best 
  54.          performance on a variety of computer hardware.  If you are 
  55.          using equipment (computer, graphics card, printer, etc) 
  56.          which VDE does not work well with, or does not seem to be 
  57.          taking full advantage of, please provide the appropriate 
  58.          technical or programmer's information from your manual so 
  59.          that future versions of VDE can support it.
  60.  
  61.      You should begin using VINST soon; once you have made changes to VDE, the 
  62. initial welcome/copyright messages in VDE and VINST will no longer appear.
  63.      Your copies of the program files will be called VDE.COM and VINST.COM, 
  64. though of course you can rename them (I usually call them V.COM and VI.COM).  
  65. To run VINST simply type:
  66.               C>vinst                 if your copy is still called "VDE.COM"
  67.         or    C>vinst V.COM           if it's called "V.COM" (or whatever).
  68.  
  69.      Any changes you make while running VINST -- choosing different options, 
  70. reading in data files, etc -- are in memory only.  You can choose "Quit" from 
  71. the main menu and VDE.COM will remain unchanged.  Only when you choose "Save" 
  72. (or "Restore defaults") does VINST modify the file VDE.COM.
  73.  
  74.      VINST can also read and write various "auxiliary data files" (type .VDx), 
  75. for user options, macro definitions, graphics, and printer support; see DATA 
  76. FILES.  VDE's ability to load such files allows modifications to these 
  77. features during editing.  In addition, they can make updating to a new version 
  78. of VDE easier: just save your old settings to files with the old VINST, and 
  79. then install them in your new copy of VDE with the new VINST.
  80.      Because installation features change with almost every release, the 
  81. version numbers of VINST and VDE must agree.  Auxiliary data files (.VDx) 
  82. change format less often, and VINST can usually read files created by other 
  83. recent versions.  In either case, if VINST can't load an older file, you will 
  84. get a "<Version error>" message, and must re-create the file.
  85.  
  86.      VINST is fully menu-driven; it will present you with a set of categories 
  87. that corresponds to each section below, starting with Installation; within 
  88. each category, each value is named and displayed, giving you the opportunity 
  89. to change it.  The program is largely self-documenting, and steps you through 
  90. each item individually.  The main menu also offers a "Help" option, which 
  91. displays some of the following information on screen to assist you.
  92.  
  93.      VINST uses several types of data entry for different parameters:
  94.   TEXT - Just type in the character(s).
  95.   LOGICAL - Yes/No.  Just type [Y] or [N].
  96.   DECIMAL - Enter a number from 0 to 255.
  97.   HEX - Enter two-digit hexadecimal byte value 00-FF.  (Don't omit lead 0's.)
  98.   BYTE STRING - The value shown in (parentheses) is the length of the current 
  99.                string.  Enter a new series of byte values.  Each may be 
  100.                entered either in HEX, as above, or by pressing the single 
  101.                quote key ['] followed by the appropriate ASCII character.  You 
  102.                can also press ["] to duplicate the existing value.  (To enter 
  103.                a null value, press ^J or ^[Enter].)
  104.  
  105.      In each case, the current value will display, and then you will be 
  106. prompted for a new one.  (Just press [Enter] to leave the existing setting.)  
  107. VINST can't always check for illegal values; be careful what you enter!
  108.      At most points in VINST, you can press [Esc] to return immediately to the 
  109. Main Menu, or ^C to abort the program.
  110.  
  111.      For the entry of codes in the Printer Installation, you may find the 
  112. following equivalence table for decimal, hexadecimal, and character values 
  113. helpful.
  114.  
  115.                                  ASCII TABLE
  116.           ASCII                                                       ASCII
  117.   Dec Hex Char   Dec Hex Char   Dec Hex Char   Dec Hex Char   Dec Hex Char
  118.   ------------------------------------------------------------------------
  119.     0  00  ^@     26  1A  ^Z     54  36   6     80  50   P    106  6A   j
  120.     1  01  ^A     27  1B ^[ Esc  55  37   7     81  51   Q    107  6B   k
  121.     2  02  ^B     28  1C  ^\     56  38   8     82  52   R    108  6C   l
  122.     3  03  ^C     29  1D  ^]     57  39   9     83  53   S    109  6D   m
  123.     4  04  ^D     30  1E  ^^     58  3A   :     84  54   T    110  6E   n
  124.     5  05  ^E     31  1F  ^_     59  3B   ;     85  55   U    111  6F   o
  125.     6  06  ^F     32  20 space   60  3C   <     86  56   V    112  70   p
  126.     7  07  ^G     33  21   !     61  3D   =     87  57   W    113  71   q
  127.     8  08  ^H     34  22   "     62  3E   >     88  58   X    114  72   r
  128.     9  09  ^I     35  23   #     63  3F   ?     89  59   Y    115  73   s
  129.    10  0A  ^J     36  24   $     64  40   @     90  5A   Z    116  74   t
  130.    11  0B  ^K     37  25   %     65  41   A     91  5B   [    117  75   u
  131.    12  0C  ^L     38  26   &     66  42   B     92  5C   \    118  76   v
  132.    13  0D  ^M     39  27   '     67  43   C     93  5D   ]    119  77   w
  133.    14  0E  ^N     40  28   (     68  44   D     94  5E   ^    120  78   x
  134.    15  0F  ^O     41  29   )     69  45   E     95  5F   _    121  79   y
  135.    16  10  ^P     42  2A   *     70  46   F     96  60   `    122  7A   z
  136.    17  11  ^Q     43  2B   +     71  47   G     97  61   a    123  7B   {
  137.    18  12  ^R     44  2C   ,     72  48   H     98  62   b    124  7C   |
  138.    19  13  ^S     45  2D   -     73  49   I     99  63   c    125  7D   }
  139.    20  14  ^T     46  2E   .     74  4A   J    100  64   d    126  7E   ~
  140.    21  15  ^U     47  2F   /     75  4B   K    101  65   e    127  7F  del
  141.    22  16  ^V     48  30   0     76  4C   L    102  66   f    --graphics:--
  142.    23  17  ^W     49  31   1     77  4D   M    103  67   g    128  80
  143.    24  18  ^X     50  32   2     78  4E   N    104  68   h    129  81
  144.    25  19  ^Y     51  33   3     79  4F   O    105  69   i    130  82 ...
  145.   -------------------------------------------------------------------------
  146.  
  147.  
  148. =============================  2. INSTALLATION  ==============================
  149.  
  150.  
  151.      VDE can display text on the screen in two very different ways: on an IBM 
  152. PC compatible (and some "near-compatibles") it can write directly to video RAM 
  153. for greater speed; otherwise, it will run on any MSDOS computer, using normal 
  154. character output with ANSI codes for screen positioning.
  155.      The IBM PC installation requires an IBM standard BIOS and video adapter 
  156. (MDA,CGA,EGA,VGA).  A Hercules (HGC) card should also work, as it is MDA 
  157. compatible.  On an EGA/VGA system the use of color mode is recommended, even 
  158. with a monochrome monitor (MODE CO80 or BW80, not MONO).  You can adjust the 
  159. keyboard handling, display colors, and cursor type to your preferences.
  160.      Special installations are available for certain "near-compatibles": 
  161. Hewlett-Packard (HP) Portable Plus, and Otrona 8:16 with IBM video emulation.  
  162. (The HP 95LX palmtop requires no special installation; VDE adapts to it when 
  163. installed for IBM PC.  But see the notes below on using VDE on the 95LX.)
  164.      The Generic (non-IBM) installation will run on any MSDOS system that 
  165. supports ANSI standard screen control sequences (you must have the statement 
  166. DEVICE=ANSI.SYS or equivalent in your CONFIG.SYS file).  You must also specify 
  167. the size of your screen.  This installation can of course also be used on IBM 
  168. compatibles, in the event that direct video access is undesirable.  It will 
  169. even work in "remote" applications, such as high-speed modem connections, with 
  170. appropriate terminal software on the user's end.
  171.      VINST can use Installation files to store your installation, menubar, and 
  172. user option settings.  These should have a file type of ".VDI", for ease of 
  173. identification.  You have the option to read in or write out such a file, as 
  174. well as proceeding to edit your installation.  VDE can load such files with 
  175. its AltU command; only the computer choice (IBM PC, etc) remains unaffected.
  176.  
  177. IBM PC PARAMETERS:
  178.  
  179. Screen colors - you can select different colors for: normal text; block text; 
  180.     markers and printer codes; soft CRs and hyphens; header; menus and 
  181.     prompts; header/menu highlights; and error messages.  Each is specified by 
  182.     an "attribute byte" consisting of two hex digits, for a background and 
  183.     foreground color.  ("17" = "1", blue background, & "7", white text.)  You 
  184.     will see a color palette displayed on screen; the color digits are:
  185.         *0 = BLACK   4 = red      *8 = GREY           C = bright red
  186.          1 = blue    5 = magenta   9 = bright blue    D = bright magenta
  187.          2 = green   6 = brown     A = bright green   E = yellow
  188.          3 = cyan   *7 = WHITE     B = bright cyan   *F = BRIGHT WHITE
  189.     (* - All MDA screens can display black, white, and bright white; in some 
  190.     cases, grey may also be visible.)
  191.          If you have an EGA/VGA display, the palette will include all 256 
  192.     colors (00-FF).  Otherwise, you will see only 128 (00-7F); on MDA/CGA 
  193.     systems, the background attributes 8-F produce blinking video (ugh).
  194.          (Note: if your soft CR color has the same background as normal text, 
  195.     VDE will adjust its background to match block text as well.)
  196. Border colors - you can select two border (overscan) colors to frame the text: 
  197.     one to operate within VDE, the other to restore on exit to DOS.  Each is 
  198.     one digit from the list above.  Example: to set a white border within VDE, 
  199.     then return to black on exit, enter "70".  To keep a black border at all 
  200.     times enter "00".  (Note: border is not visible under DESQview or 
  201.     UltraVision.)
  202.  
  203. Cursor type (D/B/U) - You can choose the cursor type you want during editing.  
  204.     A full "B"lock cursor is more easily visible on the LCD displays of laptop 
  205.     computers; some prefer "U"nderline.  Choose "D"efault to leave it whatever 
  206.     it was before VDE was run.  (In 40+ line mode, it is always a block.)
  207. Screen size (A-G,blank) - You can choose your default screen size; normally 
  208.     this is BLANK, " ", meaning whatever is in effect when VDE is loaded.  The 
  209.     letter codes have the same meaning as at the AltE command prompt:  "F", 
  210.     for example, automatically changes to 50 lines on entering VDE.
  211.             On VGA: A...G = 20,25,28,33,40,50,57 lines
  212.                 (UltraVision: B,D,F,G = 25,36,50,63)
  213.             On EGA: A...F = 17,25,29,35,43,50    lines
  214.                 (UltraVision: B,D,E,G = 25,34,43,60)
  215. Video card for 132 col mode (N...) - VDE's AltA command (132 column toggle) 
  216.     works only with supported types of video cards.  Choose:
  217.               "S" for Boca SVGA and other cards that use the "standard"
  218.                       video modes 23h and 22h for 132 column text
  219.               "A" for ATI (e.g. "EGA Wonder") -- also works with
  220.                       Diamond Speedstar VGA (Tseng chipset)
  221.               "C" for Cardinal VGA (Chips & Tech chipset)
  222.               "P" for Paradise VGA+
  223.               "T" for Trident SVGA
  224.     If you have a different card, you can experiment to see whether any of 
  225.     these will work; if not, enter "N" for none -- AltA will work only if you 
  226.     are running UltraVision.
  227.          NOTE:  Users of older Paradise VGA cards may need to keep the border 
  228.     color black, to avoid a bug affecting 132 column display colors.
  229. Need to avoid "snow" (Y/N) - Normally No.  Some video cards (like old IBM 
  230.     CGAs) experience ugly "snow" or noise when programs write directly to 
  231.     video memory.  If this happens to you, select "Y", and VDE will time its 
  232.     video access according to horizontal retrace intervals.  (Display speed 
  233.     will be somewhat reduced.)
  234.  
  235. Keyboard type (A/X/T) - Normally "A" for AT; actually, VDE detects whether you 
  236.     have an AT (enhanced) or XT keyboard, and uses the appropriate input.  But 
  237.     some "popup" (TSR) programs do not work properly with AT keyboard input; 
  238.     if you have this problem, set this to "X" for XT.  (F11, F12, and a few 
  239.     other key combinations will not work.)  Finally, the Tandy 1000 uses 
  240.     different scan codes for its F11-F12 keys; set to "T" if you have a Tandy.
  241. Retain basic Print Screen (Y/N) - Normally No; if you have EGA/VGA video, VDE 
  242.     selects the enhanced routine in the video BIOS so that the [PrtSc] key 
  243.     will print the correct number of lines with different screen sizes.  But 
  244.     this appears to conflict with use of [PrtSc] by some other software, 
  245.     including the Intel Aboveboard print buffer, and possibly DOS 5.0.  If VDE 
  246.     interferes with your use of [PrtSc], set this to Yes, then reboot.
  247.  
  248. HEWLETT-PACKARD 95LX PALMTOP USAGE NOTES
  249.  
  250.      In early 1993, a version of VDE extensively customized for the HP95LX, 
  251. called "fastWRITE", will be offered as a retail product by ACE Technologies.  
  252. It will include a number of additional conveniences:
  253.          * full multitasking (popup/hotkey) ability under SWITCH! 2.0 API
  254.          * special HP95LX-style command menus
  255.          * manages HP95LX serial port power and light sleep mode
  256.          * integrated spelling checker (VDE's will NOT work on the 95LX)
  257. Registered VDE users will be eligible for a discount toward purchase of 
  258. fastWRITE for the 95LX.  Contact ACE at (800)825-9977.
  259.  
  260.      It also remains possible to run standard VDE on the 95LX using the "IBM 
  261. PC" installation; VDE autoconfigures for the 95LX, so you can run the same 
  262. copy of VDE.COM that you use on your desktop PC.  (Note: VDE maintains a 
  263. separate set of colors for use on the 95LX; to change these, you must run 
  264. VINST on the 95LX.)  You can use HP's Connectivity Pack, or the HP82222A 
  265. serial cable with my own "ZIP file transfer" software, or the HP82222A with 
  266. the 95LX COMM utility and any PC communications program, to transfer VDE.COM 
  267. from your desktop PC onto the 95LX.
  268.      VDE can be run from Filer by highlighting VDE.COM and pressing F4 (Run); 
  269. you can also exit to DOS from Filer and run VDE from the DOS prompt.  You can 
  270. make VDE pop up from a hot-key over the internal applications with a special 
  271. EXM "loader" (see VDE-EXM, under ACCESSORIES) but you cannot pop up internal 
  272. applications over VDE.  VDE may work best without SYSMGR loaded; in any case, 
  273. allocate plenty of system RAM to DOS.  On the 95LX, the serial port must be on 
  274. and properly configured to print from VDE, but should generally be off 
  275. otherwise to extend battery life.  The HP "SERCTL" command can be run from 
  276. VDE's AltR prompt.  To save disk space, omit VDEOPT.DAT and turn off backup 
  277. files (see OPTIONS).
  278.      The 95LX [MENU] key will bring up VDE's MenuBar.  Due to the 95LX's 
  279. nonstandard keyboard, the ^[BkSp] command does not work; the grey [+],[-] keys 
  280. do not scroll the screen (use ^W,^Z); and [Shift] cannot be used with arrow 
  281. keys to mark a block (use ^KB,^KK).
  282.      See the general remarks on narrow screens under SCREEN SIZE.  When 
  283. running on the 95LX, VDE uses only the 40x16 visible area of the display.  A 
  284. few of VDE's messages (like the ^J help menus) are formatted to 80 columns, 
  285. and can be scrolled for viewing with the Left/Right arrow keys -- not the 95LX 
  286. Alt-Arrow keys (the remainder of the virtual display will be blank).
  287.      The 95LX screen uses the Roman8 character set; extended characters 
  288. entered on the 95LX will not look the same when the file is viewed on a 
  289. desktop PC with the PC8 set.  To print these characters from the 95LX, your 
  290. printer must use a Roman8 font.  (When running on the 95LX, VDE disables the 
  291. PC8-to-Roman8 translation of some printer drivers.)
  292.  
  293.  
  294. SPECIAL INSTALLATIONS:
  295.  
  296.      The "near-compatible" installations have no user-changeable parameters: 
  297. everything is preset for the particular computer.  They are:
  298.  
  299.      HEWLETT-PACKARD PORTABLE PLUS - all models.
  300.  
  301.      OTRONA 8:16 - This is for the Otrona model with IBM video emulation only.  
  302. The standard model 8:16 must use the Generic ANSI.SYS installation.
  303.  
  304. GENERIC (ANSI.SYS) PARAMETERS:
  305.  
  306. Screen colors - you can select different colors for: normal text; markers and 
  307.     printer codes; soft CRs and hyphens; header; menus and prompts; 
  308.     header/menu highlights; and error messages.  Each is specified by an 
  309.     "attribute byte" consisting of two hex digits, for a background and 
  310.     foreground color.  ("17" = "1", blue background, & "7", white text.)  You 
  311.     will see a color palette displayed on screen; the color digits are:
  312.                       *0 = BLACK   4 = red
  313.                        1 = blue    5 = magenta
  314.                        2 = green   6 = yellow
  315.                        3 = cyan   *7 = WHITE
  316.     (* - Monochrome screens can only display black and white.)
  317.     There is no block highlighting in the generic installation, and so no 
  318.     block text color choice.
  319. Running on IBM PC - set this to "Y" to enable the display of IBM graphics 
  320.     characters (ASCII 00-1F,80-FF) in text.  Use "N" if not running on a PC 
  321.     compatible; codes 00-1F will display as highlighted letters, 80-FF as a 
  322.     highlighted underline "_".
  323.  
  324. Terminal initialization - enter an optional string of code (#),bytes to be 
  325.     sent to the screen after clearing the screen, before (re)entering VDE.
  326. Terminal deinitialization - another string of code (#),bytes to be sent to the 
  327.     screen upon exiting from VDE back to DOS.  (Max. lengths: 15 bytes.)
  328.  
  329. Viewable columns (80-255) - normally 80; set to the column width of your 
  330.     display, if different.
  331. Viewable lines (16-255) - normally 25; if you have a shorter or longer default 
  332.     display (on entry to VDE), enter the length here.
  333. Fast scroll supported (Y/N) - Does your computer respond to the ANSI sequences 
  334.     for insert/delete line (Esc[L,Esc[M)?  If so, set this to "Y" for a faster 
  335.     display; otherwise "N".  (MSDOS ANSI.SYS does not support these codes; 
  336.     some enhanced console drivers, such as NANSI.SYS, do.)
  337. DEC VT/Rainbow keyboard (Y/N) - If you have a DEC computer or terminal, answer 
  338.     "Y" here.  VDE will then support its arrow keys for cursor movement, plus 
  339.     the following special keys: "Help" = help menu; "Find" = find; "Select" = 
  340.     cut; "Insert Here" = paste; "Remove" = block delete; "Prev/Next Screen" = 
  341.     page back/forward.  (NOTE: the VDE command to define a macro will be 
  342.     changed from Esc[ to Esc{ if you select this option.)
  343.  
  344.  
  345. =============================  3. MENUBAR MODE  ==============================
  346.  
  347.  
  348.      You can choose which operating mode you prefer (MenuBar or Command).  In 
  349. addition, the "User" menu bar can be configured to your taste: to provide 
  350. different keywords for accessing functions, or to add functions that are not 
  351. available in the existing menu bars.
  352.      VINST can use Installation files to store your installation, menubar, and 
  353. user option settings.  These should have a file type of ".VDI", for ease of 
  354. identification.  VDE can load such files with its AltU command.  They are 
  355. accessed through the INSTALLATION menu choice.
  356.  
  357. Use MenuBar mode (Y/N) - Do you want to start out in MenuBar mode?  If not, 
  358.     Command mode is used.  See OPERATING MODES.
  359.  
  360. "User" menu bar - If you will be using MenuBar mode, there is a special menu 
  361.     bar provided for you to configure yourself.  The five items on this bar 
  362.     are referred to as {User: item 1-5}.  To define each, you have to provide 
  363.     two things: a "keyword" and the "command" to execute.  (As usual you can 
  364.     just press [Enter] to leave the existing value alone.)
  365.          The keyword appears in the menu bar display, like "Driver" or 
  366.     "preView" in the "Print" menu: it describes what the item will do if 
  367.     selected, and the capital "D" or "V" indicates which key letter must be 
  368.     pressed to select it.  Your keyword can be up to 12 characters long, and 
  369.     must contain exactly ONE capitalized letter (A-Z), which will be the 
  370.     selection key.  (Each of the five entries must use a different key.)  An 
  371.     unused entry may be simply left blank, or filled with "---" if you prefer.
  372.          The command determines the function which will be performed when the 
  373.     item is selected from the menu.  (See COMMAND SUMMARY for a full listing.)  
  374.     Each command consists of one or two keystrokes.  The default user menu 
  375.     includes the sample entry "Autosave", which invokes the command ^KA if you 
  376.     press "A".
  377.          Example: The command ^OE, which makes the cursor line the top line on 
  378.     the screen, is not accessible via existing menu bars.  However, you can 
  379.     easily add this to the User menu bar:
  380.                 For   "{User: item #}"    type    "  make Top  "
  381.                 For   "Command:"          type    "^OE"
  382.     You now have a new MenuBar command, {User:make Top}, which is invoked by 
  383.     pressing [Esc],U,T.
  384.  
  385.  
  386. =============================  4. USER OPTIONS  ==============================
  387.  
  388.  
  389.      You can change a variety of default settings in your copy of VDE, 
  390. according to your taste.  "Default" means the state assumed when VDE is first 
  391. run, or in the absence of any previous user commands.
  392.      VINST can use Installation files to store your installation, menubar, and 
  393. user option settings.  These should have a file type of ".VDI", for ease of 
  394. identification.  VDE can load such files with its AltU command.  They are 
  395. accessed through the INSTALLATION menu choice.
  396.  
  397. Autosave interval (min.) - Enter your choice for the interval in minutes.  A 
  398.     value of 0 turns this feature off.
  399. Preserve BAKup files (Y/N) - Should a backup file (.BAK) be kept when you save 
  400.     over an existing file?  Choose "Y" to play safe, "N" to save disk space.
  401. Use ^Z as EOF mark (Y/N) - Should an EOF marker (^Z, 1Ah) be used to mark the 
  402.     end of an ASCII file (modes /A,U,N,C)?  MSDOS software should not require 
  403.     this, but some early programs (like their CP/M predecessors) did still use 
  404.     this convention.
  405. Filetypes to exclude - You can specify six filetypes (or type masks, using "?" 
  406.     wildcards) to "hide" from VDE.  (Originally set to ".COM" and ".EXE".)  
  407.     Such files will not show in the ^KF directory display (unless the filetype 
  408.     is specified explicitly), and cannot be edited.  This is a protection 
  409.     feature, for non-text files which can be damaged by trying to edit them.  
  410.     To leave an entry unused, type "...", NOT blanks.
  411. Default file mode - Which of the file modes (D,A,U,N,C,W,S,P,F,X,M) described 
  412.     in VDE.DOC do you want as the default?  (Originally "D"ocument.)
  413. Auto mode select filetypes - You can specify six filetypes (or type masks, 
  414.     using "?" wildcards) as exceptions to the above default: for example, you 
  415.     could declare all ".ASM" files to default automatically to "N" mode, or 
  416.     all files ".89?" to "W" mode.  To leave an entry unused, type "...".
  417.  
  418. Header on (Y/N) - Should the header (^OQ) start out ON?
  419. Ruler on (Y/N) - Should the ruler (^OT) start out ON?
  420. Insert mode (I/W/O) - Which insert (^V) setting do you want to start out with: 
  421.     Insert, Word insert, or Overstrike (insert off)?
  422. Auto format (Y/N) - Should auto format (^OM) start out ON?
  423. Right justify (Y/N) - Should right justification (^OJ) start out ON?
  424. Double spacing (Y/N) - Should double spacing (^OS) start out ON?
  425. Proportional spacing (Y/N) - Should proportional spacing (^OK) start out ON?
  426. Hard CR display (Y/N) - Should Hard CR display (^OB) start out ON when editing 
  427.     in document modes?
  428. Hyphenation (Y/N) - Should hyphenation (^OH) start out ON in documents?
  429. Case-INsensitive search (Y/N) - Do you want string searches (^QF) to be case 
  430.     insensitive by default?  Normally, No.  (If Yes, specifying the "U"pper- 
  431.     case option while using ^QF will force a case SENSITIVE search.)
  432.  
  433. Left and Right margin columns (1-255) - Default margin settings for Document 
  434.     modes.  Set both to 1 to disable wordwrap and reformatting entirely.
  435. Fixed tab display width (4,8,16) - Hard tabs display at fixed column 
  436.     intervals.  (Normally 8;  4, 8, and 16 are the ONLY legal choices.)
  437. Reserve status line (Y/N) - Do you want VDE to reserve the bottom (normally 
  438.     25th) screen line for use as a status or function key line by other 
  439.     software?  (Normally No, VDE uses this line for text.)
  440. Scroll overlap (0-255) - This is the number of lines of overlap between 
  441.     screens when scrolling: the smaller, the larger the scroll.  Originally 2, 
  442.     for a nearly full scroll.  Must be smaller than your screen size!
  443. Align new page with screen (Y/N) - When you use the page find commands ^QI, 
  444.     ^QL, ^QN, do you want the first line at the top of the screen?  Originally 
  445.     No, it is positioned in the same way as an ordinary Find.
  446. Beep on error (Y/N) - Do you want a beep when a VDE error message displays?
  447.  
  448. [BkSp] (^H) deletes to left (Y/N) - Should the [BackSpace] (^H) key delete 
  449.     characters?  Originally No, it just moves the cursor left.
  450. [Del] deletes at cursor (Y/N) - Should the [Del] key delete the cursor 
  451.     character?  Originally No, it deletes the previous one.
  452. ^[BkSp] deletes word left (Y/N) - Should ^[BackSpace] delete the word to the 
  453.     left?  Originally No, it deletes only the previous character.
  454. [Home,End] go to screen top/bottom (Y/N) - Should [Home,End] move to the top 
  455.     or bottom of the screen?  Originally No, they move to line start or end.
  456.  
  457. Variable tab stops -  Enter up to 8 variable tab stop columns, in ascending 
  458.     order.  Fill unused values with 0.  Originally: 6, 15, 35, 55.
  459.  
  460. Show time as AM/PM (Y/N) - Do you want the time stamp to display in 12 hour 
  461.     format (AM/PM)?  Originally Yes.  If No, the time shows in 24 hour format.  
  462.     (Affects AltT command and ^T in print headers.)
  463. Show date in Euro format (day,mo,yr) (Y/N) - Do you want the date to display 
  464.     in European format?  Originally No, meaning US Format (mo,day,yr).  
  465.     (Affects AltD command and ^D in print headers.)
  466. Show date numerically (Y/N) - Do you want AltD to enter the date numerically 
  467.           (1/15/88)?  Originally No, meaning verbose (January 15, 1988).
  468.  
  469.  
  470. =========================  5. PRINTER INSTALLATION  ==========================
  471.  
  472.  
  473.      Printers vary enormously.  VDE can accomodate two printer drivers, each 
  474. of which can be installed to take advantage of your printer's special 
  475. features.  (Within VDE, the AltV command can be used to select the driver to 
  476. use when printing.)  You can use these for two different printers, or as two 
  477. different "style sheets" to print in different formats (margins, line spacing, 
  478. etc) on the same printer.  The default installed in VDE is a "SIMPLE" driver 
  479. that can send plain text to any printer, but does not support any print 
  480. controls other than underline and strikeout.  (The "SIMPLE" driver is also 
  481. recommended for many daisy-wheel or typewriter-style printers.)  Many pre- 
  482. defined drivers for other printers can be selected from a menu within VINST.
  483.      One thing you are likely to want to modify is the printer initialization, 
  484. to which you can add codes to modify the default page margins, tab settings, 
  485. etc for your printer.
  486.      Most of the drivers in the VINST menu implement only basic codes for 
  487. print effects like italics and proportional printing; you can, however, modify 
  488. them to your taste, to implement any additional features (fonts, etc) you have 
  489. available.  After choosing a driver from the Menu, return and select "Edit 
  490. current driver".  (To modify the Alternate driver, you must switch it to the 
  491. primary one, then switch it back afterward.)
  492.      An example of a more fully configured driver is "HPLJ-PacPg 25in1".  This 
  493. can be used with a Hewlett-Packard LaserJet printer (or compatible) equipped 
  494. with a Pacific Page 25-in-1 cartridge (or any other that provides the fonts 
  495. indicated below).  It offers the following effects:
  496.         CODE  EFFECT
  497. Normal print  Prestige Elite 10 point font, printer margin set to column 6
  498.          ^OK  Times Roman 10 point proportional font
  499.     ^B,^S,^Y  Boldface, Underline, Italics (all fonts)
  500.        ^T,^V  Superscript, Subscript using 7 point Prestige font
  501.           ^D  switch to Times Roman from Prestige and back
  502.        ^A,^N  switch to Courier 12 point from Prestige and back
  503.           ^Q  Mini Gothic 3.6 point
  504.           ^W  Presentation Bold 18 point
  505.           ^E  Math Elite 10 point
  506.           ^R  return to Prestige from ^Q,^W,^E
  507.  
  508.      If your printer is not on the driver menu, but emulates or resembles one 
  509. that is, start out using that driver, and refine it as needed.  Failing this, 
  510. you can start out with the "SIMPLE" driver and, referring to your printer 
  511. manual, install all the necessary codes yourself.  (In this event, please 
  512. consider sending this information so that a new driver can be added to VINST.)  
  513. VDE does not support Adobe Postscript; but you may be able to add the codes to 
  514. switch into your printer manufacturer's native mode, then return to 
  515. Postscript, to your printer initialization and deinitialization (see below).
  516.  
  517.      VINST can use special Printer Driver files to store and retrieve other 
  518. printer definitions.  This makes it easy to save your installation and to pass 
  519. it along to others.  These files should have a type of ".VDP".  When editing 
  520. in VDE, the AltU command may be used to load such a file, putting any number 
  521. of different printer drivers at your disposal.  In VINST, you have the option 
  522. to read in or write out such a file, as well as editing the following values 
  523. individually.
  524.  
  525. Printer ID - Identify the printer you are installing.  (16 characters)
  526. Printer device - Normally "PRN", but you can choose a specific port (like 
  527.     LPT2) if your system has several printers.
  528.  
  529. Extended character set (P/R/N) - Specifies how "extended ASCII" characters 80- 
  530.     FF (graphics or foreign characters) will print.  This depends on the 
  531.     sequence of characters in your printer's fonts.  Your choices are:
  532.        <P>C8 - the standard IBM PC character set.  No translation in printing.
  533.        <R>OMAN8 - an arrangement common in laser printer fonts.  VDE will 
  534.               translate IBM graphics into Roman8 equivalents where possible.
  535.        <N>one - your printer doesn't print characters in this range at all.  
  536.               VDE will "emulate" IBM graphics, choosing overstruck pairs of 
  537.               standard characters that come close.
  538.     Note that if you are using a non-standard screen font that agrees with 
  539.     your printer font, whatever it may be, you should choose "P".
  540. Printer type (H/F/L/O) - Enter "H" for HP LaserJet or DeskJet compatible, "F" 
  541.     for Epson FX (9 pin) or compatible, "L" for Epson LQ (24 pin) or compat- 
  542.     ible, or "O" for any other type.
  543. Send LF after CR (Y/N) - Normally Yes.  But with a few printers, which manu- 
  544.     facture their own LineFeed on receiving a Return, you will need No here.
  545.  
  546. Page length (0-255) - The number of text lines to print on a page.  An 11" 
  547.     sheet gives 66 lines of print at a standard spacing of 6 lpi; most 
  548.     printers can actually print about 60-64 lines.  Be sure also to leave room 
  549.     on the page for the following margin settings, if used.  Default is 58.
  550. Top margin (0-255) - The number of blank lines to skip as a top margin before 
  551.     printing the number of text lines set above.  Default is 0.
  552. Top margin if header used (0-255) - The number of lines to skip as a top 
  553.     margin before printing the header.  Default is 0.
  554. Lines to skip between header and text (0-255) - Blank lines to leave between 
  555.     header and text.  Also determines lines between text and bottom page 
  556.     number, if used.  Default is 2.
  557. Left margin (0-255) - Set the number of blank columns to skip as a left 
  558.     margin, shifting the entire printout to the right.  Default is 0.  (Note: 
  559.     most printers offer an Esc command to set an internal left margin in dot- 
  560.     columns or inches.  If you need a left margin, you can get more consistent 
  561.     and reliable results by including such a command in your initialization 
  562.     string.  If you can't do this, install a value here and VDE will print 
  563.     spaces for a margin.)
  564.  
  565.      The following menu choices allow you to modify the codes that are part of 
  566. your printer driver.  For all of these codes, the existing values (if any) 
  567. will display, first in more or less readable "character" form and then as a 
  568. string of hex digits, preceded by the length in parentheses.  Press [Return] 
  569. alone to leave the codes unchanged, or ^[Return] to delete them entirely, or 
  570. enter new codes -- either in hexadecimal, or as character values by pressing 
  571. the single quote ['], then a character.  When finished, press [Return].
  572.      Any one string can be up to 127 bytes long; the total available for use 
  573. is about 450 bytes.
  574.  
  575. [A]-Initialization, etc - This is an optional string of code to send to the 
  576.     printer before each print job, usually to set default margins, line 
  577.     spacing, font, etc.  (NOTE: the ^KP command has an option to specify 
  578.     additional codes at print time.  See PRINTING.)
  579. [B]-Deinitialization - This is another string to send after each print job, to 
  580.     restore the printer to the desired state on exit.
  581. [C]-Envelope setup - This string will be sent in place of the usual 
  582.     initialization when you address an envelope with ^KPA (see ENVELOPES).  
  583.     For many printers you will need no special codes here; or, you might find 
  584.     that a linefeed or two, perhaps also a left margin command, is useful to 
  585.     position the print properly on the envelope.  You should use a pica font 
  586.     (fixed, 10 cpi).
  587.          The setup codes in VINST's HP LaserJet drivers assume that you will 
  588.     insert the envelope end-on in the default paper tray, and consequently 
  589.     they use a landscape font (Courier 12).  They do not specify "envelope 
  590.     size" forms, so there is no need to change the form size on the printer 
  591.     panel.  If you are feeding envelopes from a different paper tray, you will 
  592.     have to add codes here to specify this tray.
  593.          You must also be sure that your deinitialization contains any codes 
  594.     necessary to return to the default tray, orientation, etc. after 
  595.     addressing an envelope.  Printing envelopes can be complicated; see your 
  596.     printer manual.
  597. [D]-Proportional (^OK) - Enter the codes needed to produce a proportionally 
  598.     spaced font when you print while in proportional mode (^OK).  Like the 
  599.     "toggles" below, you also need to supply a second string to turn this off 
  600.     and return to fixed spacing afterwards.
  601.  
  602. TOGGLES: [E]-Bold, etc - For six of the seven printer toggles (not ^X), you 
  603.     need to tell VDE the codes to send to your printer to produce the desired 
  604.     effect, then turn it off again.  The conventional meanings of the toggles 
  605.     are:      ^B  boldface         ^Y  italic/ribbon color
  606.               ^D  doublestrike     ^T  superscript
  607.               ^S  underline        ^V  subscript
  608.     but you can use them for anything you want.  Example: Epson FX printers 
  609.     require three-byte sequences to turn continuous underlining on and off:
  610.            Underline on   "Esc - 1"    hex 1B 2D 31   decimal 27 45 49
  611.                     off   "Esc - 0"        1B 2D 30           27 45 48
  612.     You can enter the data in hex or characters, or any mixture thereof:
  613.                    [G]...    :  1B 2D 31      <--- entry in hex format
  614.                    ...and off:  'Esc '- '0    <--- or by characters
  615.     You should find all necessary codes in your printer manual.
  616.          (NOTES: ^PS will underline text by overstriking with "_" if you do 
  617.     not install codes for it.  ^PX requires no installation at all.)
  618.  
  619. SWITCHES: [K]-User1, etc - The same idea, but for switches, which send the 
  620.     same codes every time they are used.  WordStar calls the switches:
  621.           ^Q,W,E,R    user 1,2,3,4   (no standard meaning)
  622.           ^A,N        alternate, normal pitch
  623.     But once again, you can use them for different fonts, printer bin 
  624.     selection, or anything else you like.
  625.  
  626.  
  627. ==========================  6. DEFAULT MACRO KEYS  ===========================
  628.  
  629.  
  630.      VDE has a set of 36 macro keys assignable to the commands Esc0...9 and 
  631. EscA...Z.  The default macro definitions are those attached to these commands 
  632. when VDE is first entered.  By changing them you can configure VDE to suit 
  633. your own specialized writing requirements.  (Any keys defined with Esc] while 
  634. using VDE override these defaults.)
  635.  
  636.      VINST can use Key Definition files to store macro key sets.  These should 
  637. have a file type of ".VDK", for ease of identification.  You have the option 
  638. to read in or write out such a file, as well as editing the keys individually.  
  639. (VDK files can also be read or saved with VDE's AltU command, but only VINST 
  640. can display the definitions, or change those in VDE.COM itself.)
  641.      There are several different ranges of keys, which can be displayed and 
  642. modified in a set of 10 at a time (for example, keys 0-9, or A-J).  You can 
  643. also copy definitions from one macro or function key to another.
  644.      VINST gives you a display much like this:
  645.  
  646.       Macro Keys:  (___ bytes free)     <---- note room available
  647.       Esc0:<>
  648.       Esc1:<>                           <---- "<>" flag means undefined key
  649.       Esc2:<>
  650.       Esc3:[Esc];^C                     <---- normal macro definition
  651.       Esc4:<>
  652.       Esc5:<N>World Wide Widgets Inc.   <---- "<N>" flag means No-rpt key
  653.       Esc6:<>
  654.       Esc7:<Q>^QR^KB^QC^KK^KC           <---- "<Q>" flag means Quiet key
  655.       Esc8:<>
  656.       Esc9:<QN>^QS[!Down]               <---- "[!Down]" means Shift-DownArrow
  657.  
  658. Just select the number of the key you want to redefine, then type in the new 
  659. definition, much as you would in VDE.  All the same rules apply; there is a 
  660. 128-character length limitation.  ^U aborts; ^P must be used to enter ^U, 
  661. [Enter] (^M), [BkSp] (^H), or ^P itself.
  662.      The Esc key and special IBM PC keys like PgUp will display by name within 
  663. brackets: [Esc], [PgUp].  Shift, Ctrl, and Alt combinations are indicated by 
  664. "!", "^", and "@", as in "[!Down]", "^J", "@D".  Many of these keys cannot be 
  665. entered into a macro definition with VDE's Esc[ command, but they can be 
  666. recorded with Esc", and can be entered in VINST.
  667.      VDE comes with a macro key file EXAMPLES.VDK, containing several macros 
  668. previously discussed under MACROS and MACRO PROGRAMMING:
  669.  
  670.    Esc1:<QN>^QR^N@D^OF                            ;put date at top right
  671.    Esc2:<QN>^QS^S^S[Esc]= [^D^D                   ;move to start of paragraph
  672.    Esc3:<QN>[Esc]~.1^S[Esc]1[Esc]~.<^D[Esc]= 2[Esc]=^M2   ;move to start
  673.             ^S^S[Esc]!1[Esc]2^D[Esc]= 2[Esc]=^M2          ;  of sentence
  674.    Esc4:<QN>^QS^X[Esc]= ][Esc]=^M]^S ^D[Esc]![    ;soften hard-CR paragraph
  675.  
  676.  
  677. =========================  7. DEFAULT FUNCTION KEYS  =========================
  678.  
  679.  
  680.      VDE also has a set of 48 Function Keys, corresponding to the [F1]...[F12] 
  681. keys in their normal, Shift-, Ctrl-, and Alt- usage (referred to collectively 
  682. here as F1...F48).  These are identical in features and functions to the Macro 
  683. Keys discussed above.  You can easily configure these to match the standard 
  684. function-key configuration for Wordstar's key overlay, to correspond to Word 
  685. Perfect function-key usage, or in any other way you like.
  686.      VINST can use Function Key Definition files to store function-key sets.  
  687. These should have a file type of ".VDF", for ease of identification.  You have 
  688. the option to read in or write out such a file, as well as editing the keys 
  689. individually.  (VDF files can also be read or written with VDE's AltU command, 
  690. but only VINST can display the definitions, or change those in VDE.COM itself.)
  691.      VINST gives you a display much like this:
  692.  
  693.       Function keys, #1-10:  (___ bytes free) <---- note room available
  694.       F1:<>
  695.       F2:<>                                   <---- "<>" flag means empty
  696.       F3:<>
  697.       F4:<QN>^OL5^M^OR60^M                    <---- quiet, no-repeat key
  698.       F5:<>
  699.       F6:<>
  700.       F7:<>
  701.       F8:<>
  702.       F9:<QN>^PS
  703.       F10:<QN>^PY
  704.  
  705. This works just like the macro key display above, with four sets of 10 keys to 
  706. define, Normal, Shift(!), Ctrl(^), and Alt(@), and if you have an Enhanced 
  707. keyboard, a separate additional set of 8 keys for the [F11],[F12] keys in each 
  708. of those states.
  709.      VDE includes sample function-key files which you can read in to define 
  710. the function keys according to the usage of WordStar or Word Perfect.  The 
  711. WordStar default definitions (for version 4 and later) in WS4.VDF are:
  712.  
  713. WS4.VDF      NORMAL      SHIFT        CTRL             ALT
  714.      F1       ^J          ^OB          ^QF         Vertical bar graphic
  715.      F2       ^U          ^OC          ^QA         Horizontal bar
  716.      F3       ^PS                      ^L          Upper-left corner
  717.      F4       ^PB                      ^QI         Upper-right
  718.      F5       ^Y          ^KY          ^OL         Lower-left
  719.      F6       ^T          ^KH          ^OR         Lower-right
  720.      F7                   ^KV                      Upper T graphic
  721.      F8                   ^KC                      Lower T
  722.      F9       ^KS         ^KB          ^QS         Left T
  723.      F10      ^KD         ^KK          ^QD         Right T
  724.  
  725. The WP.VDF file will not "turn VDE into Word Perfect", but it does provide a 
  726. considerable degree of keystroke compatibility.  You can assign any other 
  727. functions desired to unused keys (e.g. [F9]):
  728.  
  729. WP.VDF       NORMAL      SHIFT        CTRL             ALT
  730.      F1       ^U         Esc?Y        AltR
  731.      F2       ^QF         ^QF                          ^QA
  732.      F3       ^J                      Esc?C            ^OD
  733.      F4       ^OG                     Esc?B           Esc?B
  734.      F5       ^KF        AltD
  735.      F6       ^PB         ^OC                          ^OF
  736.      F7      Esc?F        ^KP
  737.      F8       ^PS        Esc?S        Esc?T           Esc?S
  738.      F9
  739.      F10      ^KS        Esc?F        Esc"
  740.  
  741.  
  742. ==========================  8. GRAPHICS CHARACTERS  ==========================
  743.  
  744.  
  745.      VDE allows text to contain a limited, but variable, set of 32 characters 
  746. in the range 80-FFh (on an IBM PC, these are typically graphics or foreign 
  747. characters; see FOREIGN CHARACTERS and GRAPHICS).  In addition, the code ^Z 
  748. (1Ah) must be treated as a graphics character.  VINST lets you specify your 
  749. own default graphics set.  Keep a fair amount of space free in it if you 
  750. frequently work with files with many foreign or graphics characters, in order 
  751. to avoid overflowing the table.
  752.      VINST can use Graphic Definition files to store graphic character sets.  
  753. These should have a file type of ".VDG", for ease of identification.  You have 
  754. the option to read in or write out such a file, as well as editing the keys 
  755. individually.  VDE can also write such files with its AltU command.
  756.  
  757.      You will be shown the current definitions, in the same format as the VDE 
  758. Graphics command.  You may select any entry to redefine (A-Z, 1-6) whether 
  759. vacant or not; or, you may clear them all.  In VINST, new graphic codes must 
  760. be entered by hex value, from 80 to FF (and 1A); a full list of graphics 
  761. characters (80-FF) can be displayed for your selection if you need it, by 
  762. typing "?" at the definition prompt.  Simply pressing [Enter] means "free" or 
  763. undefined.
  764.      Note that your Printer Installation determines how graphics will print.
  765.  
  766.  
  767. ===========================  9. CHARACTER WIDTHS  ============================
  768.  
  769.  
  770.      In order to judge the margins correctly when formatting, VDE's 
  771. proportional printing feature (^OK) needs to know how wide each character is 
  772. when it prints.  The default width table, based on a 10-point Times Roman 
  773. font, will probably work fairly well with any proportional font ("m" is wider 
  774. than "i", and so on).
  775.      If you would like to fine-tune this table to correspond to your favorite 
  776. font instead, use VINST to modify the width table as needed: you can select 
  777. each character, then enter its width (in units of 1/360") as a decimal value.
  778.      The easy way to determine these widths is to print out a file with lines 
  779. of 60 of each character.  (Rather than type that out by hand, you can use the 
  780. macro command to repeat each letter 60 times.)  Measure the length of each 
  781. line in inches, and multiply by 6: that is the character width in 1/360".  The 
  782. result is typically between 16 and 48.)
  783.      Note that changing the width table doesn't affect how your printer 
  784. operates -- just how VDE judges the length of each line for reformatting in 
  785. proportional mode.
  786.      VINST can use Character Width files to store width data for the 
  787. proportional font(s) you use.  These should have a file type of ".VDC", for 
  788. ease of identification.  You have the option to read in or write out such a 
  789. file, as well as editing the width table.  VDE can load such files with its 
  790. AltU command.
  791.  
  792.  
  793. ==========================  10. RESTORE DEFAULTS  ============================
  794.  
  795.  
  796.      This option on the VINST menu is provided in the event that you want to 
  797. undo any changes that have been made to your copy of VDE.  This will return 
  798. VDE.COM to the state it was distributed in: installation for IBM PC; all User 
  799. Options restored to their original defaults; no Macro or Function Keys 
  800. (except, for convenience, [F1]=help); SIMPLE printer driver; original Graphics 
  801. characters and Character widths.  VINST prompts you to confirm that you really 
  802. want to do this before proceeding.
  803.  
  804.  
  805.  
  806. ===================================[end]======================================
  807.